








protocol extensions 


By S. van de Vries 


Without question, the EEDTS Pro proto- 
col has been the subject of most discus- x 
sions related to EEDTS Pro, due to the J 
fact that it differs from the old EEDTS ~“ 
and the Motorola protocol. 


Furthermore, many users and software sup- 
pliers have found it difficult to convert 
addresses and date to the trits coding 
required by the EDTS controller. 

Consequently, the protocol has been 
extended to include the command set listed 
in Table 1. 

Naturally, the existing command set (as 
described in the EEDTS Pro book) is still fully 
supported, and the new control unit is down- 
wards compatible with the old version. 

The Marklin protocol formed the starting 
point for this move, but since that protocol 
does not have any commands for the extra 
functions, an extra byte has been specifically 
added (in particular, for the locomotive con- 
trol commands). 


General command structure 


The EEDTS Pro control unit communicates 
with the PC via the RS232 port using fixed 
settings of 9600 baud with no parity, eight 
data bits and one stop bit. In order to ensure 
correct data transfers, a design has been 
used in which a response byte is sent back 
for every byte that is sent to the control unit. 

A control unit instruction may consists of 
1, 2, 3 or 4 bytes, with the first byte being the 
command byte. 

In general, the command byte is sent back 
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verbatim as an indication that the 
instruction was correctly received, 
except in the case of the return com- 
mands (single-byte control unit 
instructions), for which return infor- 
mation is sent back directly in order 
to achieve a high data rate. 

If the control unit cannot send the 
information to the track (for instance, 
if the booster is out of service due to 
a short circuit), the value ‘65’ is sent 
back following the command byte, in 
order to inform the PC of this situa- 
tion. 

In order to inform the control unit 
in turn that the booster is out of ser- 
vice, a small modification to the 
booster interface is necessary. This 
will be described in the following 
instalment, along with the address- 
ing of the keyboard and stand-alone 
controller. 


Locomotive command 


The first byte of the locomotive com- 
mand can have a value of 0-15. This 
value represents the speed, bearing 
in mind that in the old format, speed 
level ‘1’ is the ‘reverse’ command (in 
the Marklin protocol, it is ‘15’). 





The second byte that is sent rep- 
resents the locomotive address. The 
first 80 addresses correspond to the 
80 available addresses in the Marklin 
format. However, since there is room 
for 256 addresses in the new format, 
the command has been extended to 
256 addresses. 

The only existing ‘standard’ for 
this sequence is to be found at 
Uhlenbock, which is why this 
sequence has been chosen. 

The third byte provides informa- 
tion regarding the format, direction 
of travel and extra functions. The 
meanings of the individual bits in 
the old format are shown in Table 2, 
while the same information for the 
new format is shown in Table 3. For 
convenience, the values are also 
shown in decimal notation. 

It is now possible to generate old- 
format functions. An important dif- 
ference between the two tables is 
that in the old format, all four func- 
tions are modified by each byte, 
while in the ‘new style’ table a sep- 
arate byte is used to set each func- 
tion. 

In the old format, if it is not 
desired to modify the extra func- 
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Table |. The extended command set. 






























































Command | Normal | Short | Second Resson Third Response Fourth Response 
byte response | circuit byte P byte P byte P 
Locomotive See Tables ; 
omrand 0-15 0-15 65 0-255 0-255 2&3 Third byte 
Last changed 190 1..64 65 
Return-signalling module 192 - 255 0-255 65 
Turnout (switch) reset 32 32 65 
Turnout (switch) to the left 33 33 65 0-255 0-255 
Turnout (switch) to the right 34 34 65 0-255 0-255 
Prossain manual controller 40 40 65 16 - 23 0-255 0-255 Previous 0-255 Previous 
8 24 - 31 Speed address status 
4| 41 65 16 - 23 0-255 0 Address 0 Status 
Read manual controller 
24 - 31 Speed 
tions, a ‘0’ or a ‘3’ is sent (the ‘n’ in Turnout activates the ‘red’ output. Even the peculiar- 


the table indicates that F1-F4 do not 
change). The new format also 
includes the ‘reverse’ and ‘forward’ 
commands. 

The observant reader may have 
already noticed that two bits (b1 and 
b2) are reserved for the FO function 
and that these bits always have the 
same values in the table (’00’ or ‘01’). 
The values ‘01’ and ‘10’ are also 
allowed, but they are reserved for 
assignment to future functions. 


Return commands 
Last changed 


The ‘last changed’ command (‘190’) 
will doubtless prove to be useful for 
real-time control in layouts having a 
large number of return-signalling 
units. The response byte contains 
the address of the return signaller 
whose input state has changed 
(with respect to the time at which 
this unit was last read). This makes 
it possible to quickly determine 
which unit must be read. 


Return-signalling modules 


The return-signalling units can be 
read using commands 192-255. 

Command ‘192’ is used to read 
the first unit, ‘193’ is used to read the 
second unit and so on, up to ‘255’ for 
the 64th EEDTS return signalling 
unit (or 9-16 of the 32nd Märklin 
S88). 

The value that the control unit 
sends back provides a binary repre- 
sentation of the inputs (in the case of 
a detector module, this is the loco- 
motive address). 
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(switch) commands 


The turnout (switch) commands are 
exactly the same as the Märklin 
commands. For instance, command 
"33-(1-4)’ activates the ‘green’ output 
of a k73, while command '34-1-4)’ 


ity that ‘33-0’ and ‘34-0’ represent the final 
two outputs of decoder 64 has been imple- 
mented. Turnout activation is rescinded using 
command ‘32’. 

These commands limit the number of 
decoders to 64. If a larger number of decoders 
must be supported, recourse can be made to 


Table 2. The old Motorola format. 
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the normal EEDTS command set, which can 
address up to 240 decoders. 


Programming 
manual controllers 


Program manual controller 

Command ‘40’ can be used to program the 
manual controllers. The command byte (‘40’) 
is followed by a second byte that can have a 
value of 16-23. The value ‘16’ selects con- 
troller 1, ‘17’ selects controller 2 and so on, up 
to ‘23’ for controller 8. 

If a value in the range of 16-23 is chosen, 
the address modification is temporary and is 
no longer valid after a power-down. In order to 
achieve a permanent address modification, a 
value in the range of 24-31 must be chosen 
(‘21’ for controller 1 etc., up to ‘31’ for con- 
troller 8). 

Once the control unit has received the sec- 
ond byte, it will send back the controller sta- 
tus. This can lie in the range of ‘0’ (control 
rotated fully to the left) to ‘255’ (control 
rotated fully to the right). 

The third byte determines the address 
that must be set for the controller, while the 
fourth byte indicates the format of the con- 
troller and the functions that are already 
enabled or disabled in the locomotive (or in 
the PC software). In this way, for example, 
the control unit knows that if the F3 function 
is enabled, it must send the ‘FO off’ command 
to the locomotive when the FO button is 
pressed on the manual controller. 

The bits in the fourth byte have the fol- 
lowing meanings: 


b8 b7 
s/h o/n f/r 


b6 b5 b4 b3 b2 b1 
F4 F3 F2 F1 FO 


For example, if the fourth byte is assigned a 
value of '36’ (binary ‘00100100’), the controller 
settings are as follows: 


s/h =0 format selection: 
1 = format set by software 
0 = format set by hardware 
o/n=0 format: 
1 = old format 
0 = new format 


f/r=0 direction of travel: 
1 = forward 
0 = reverse 

F4=0 _ (F4 off) 

F3=0 _ (F98 off) 

F2=1 (F2on) 

F1=0 (F1 off) 

FO=0 _ (FO off) 


If the s/h bit is ‘1’, this means that the format 
(old or new) is not determined by the selec- 
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Table 3. The new Motorola format. 



















































































b8 b7 b6 b5 b4 b3 b2 bl Decimal Description 

0 0 0 0 0 | 0 0 4 FI off FO off 
0 0 0 0 0 I I | 7 FI off FO on 
0 0 0 0 | 0 0 0 8 Fl on FO off 
0 0 0 0 I 0 | | lI FI on FO on 
0 0 0 0 I | 0 0 12 F2 off FO off 
0 0 0 0 | | | | 15 F2 off FO on 
0 0 0 I 0 0 0 0 16 F2 on FO off 
0 0 0 | 0 0 | | 19 F2 on FO on 
0 0 0 I 0 I 0 0 20 F3 off FO off 
0 0 0 | 0 I I | 23 F3 off FO on 
0 0 0 | | 0 0 0 24 F3 on FO off 
0 0 0 | | 0 | | 27 F3 on FO on 
0 0 0 | | I 0 0 28 F4 off FO off 
0 0 0 | I | I | 31 F4 off FO on 
0 0 | 0 0 0 0 0 32 F4 on FO off 
0 0 | 0 0 0 | | 35 F4 on FO on 
0 0 l 0 0 l 0 0 36 Reverse FO off 
0 0 l 0 0 l l l 39 Reverse FO on 
0 0 | 0 | 0 0 0 40 Forward FO off 
0 0 l 0 l 0 l l 43 Forward F0 on 














tion diode in the manual controller, 
but instead by the o/n bit. If the s/h 
bit is ‘0’, the format is determined by 
the selection diode in the manual 
controller. 

After the third (address) byte has 
been sent to the control unit, the con- 
trol unit sends back the address set 
for the manual controller (at the time 
that the command was sent). Follow- 
ing the fourth byte, the control unit 
sends back the previously read con- 
troller status in the response byte. 
The response data can be used by 
the EEDTS Pro software, for example, 
to restore the original values when 
control is passed from a software 
controller to a manual controller. 

The eight manual controllers can- 
not be disabled and will continually 
send information to the track. You 
should therefore avoid having more 
than one controller set to the same 
address (except for address ‘0’) or 
having the PC send commands to 
addresses that are being used by 
manual controllers. 

In order to avoid problems arising 
from the manual controllers, it is a 
good idea to first set all manual con- 


trollers (or all manual controllers that 
are not actively in use) to address ‘0’ 
when starting up your own program. 


Read manual controller 


Command ‘41’, which is used to read 
out a manual controller, is closely 
related to the ‘program manual con- 
troller’ command. However, the ‘read 
manual controller’ command only 
reads data and does not change any 
controller settings. In this case as 
well, controller status is returned fol- 
lowing the second byte. 

The values following the third and 
fourth bytes are the same as for the 
‘program manual controller’ command, 
with the understanding that here it 
does not matter what value is sent by 
the PC, since the control unit does not 
do anything with these values. 

This completes our presentation 
of the most important changes in the 
new control unit protocol. The new 
microcontroller is available from 
Readers Services under order num- 
ber 010088-41 and can simply be fit- 
ted on the existing control unit cir- 
cuit board. 

(010088-2) 
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